home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Memphis Amiga Group / MAG Science Disk 1 (1992-07)(Memphis Amiga Group).zip / MAG Science Disk 1 (1992-07)(Memphis Amiga Group).adf / ELECTRON / MANUAL < prev    next >
Text File  |  1992-06-02  |  17KB  |  385 lines
  1. #############################################################################
  2. #####                                                                   #####
  3.  #####                      ELECTRON WORLD v2.01                       #####
  4.   #####                   ~~~~~~~~~~~~~~~~~~~~~~~~                    #####
  5.    #####           Written by Stefan Zeiger in 5/6/7/8 1991          #####
  6.   #####          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~         #####
  7.  #####                  (c) 1991 by ! WIZARD WORKS !                   #####
  8. #####                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~                  #####
  9. #############################################################################
  10.  
  11.  
  12.  
  13.                   ## +---------- IMPORTANT ----------+ ##
  14.                 #### |           ~~~~~~~~~           | ####
  15.               ###### | THIS PROGRAM IS SHAREWARE !!! | ######
  16.             ######## |  READ "DISCLAIMER" FOR MORE   | ########
  17.               ###### |        INFORMATION !!!        | ######
  18.                 #### |                               | ####
  19.                   ## +-------------------------------+ ##
  20.  
  21.  
  22.  
  23.                            --------------------
  24.                            1. TABLE OF CONTENTS
  25.                            --------------------
  26.  
  27.  
  28.            +---------------------------------------------------+
  29.            |   1.  Table of Contents                           |
  30.            |   2.  What is Electron World ?                    |
  31.            |   3.  The rules for the Electron World            |
  32.            |   4.  How to create a field for Electron World    |
  33.            |   5.  The "Options" menu                          |
  34.            |   6.  Processing the fields                       |
  35.            |   7.  Operating the editor                        |
  36.            |   8.  Other features                              |
  37.            |   9.  The demo fields                             |
  38.            |  10.  Known bugs                                  |
  39.            |  11.  Technical information                       |
  40.            |  12.  Disclaimer                                  |
  41.            |  13.  History                                     |
  42.            |  14.  Some additional things                      |
  43.            |  15.  Appendix                                    |
  44.            +---------------------------------------------------+
  45.  
  46.  
  47.  
  48.                         ---------------------------
  49.                         2. WHAT IS ELECTRON WORLD ?
  50.                         ---------------------------
  51.  
  52.  
  53. Electron World is a cellular machine. It uses a ->field of 108 by 58 ->cells,
  54. that is processed through many ->steps.
  55.  
  56.  
  57.  
  58.                     -----------------------------------
  59.                     3. THE RULES FOR THE ELECTRON WORLD
  60.                     -----------------------------------
  61.  
  62.  
  63. Each cell may have one of four states :
  64. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  65.    - Background : black or yellow (Yellow can be used to mark special places
  66.                   or to write something into the field)
  67.    - Wire : blue
  68.    - Electron head : red
  69.    - Electron tail : pink
  70.  
  71. From step to step the cells of the field are changed :
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73.    - All electron tails become wire cells
  74.    - All electron heads become electron tails
  75.    - Wire cells become electron heads, if there were one or two electron heads
  76.      on the eight cells around them (in the last step)
  77.    - Background cells (black) and markers (yellow) remain unchanged
  78.  
  79.  
  80.  
  81.                 -------------------------------------------
  82.                 4. HOW TO CREATE A FIELD FOR ELECTRON WORLD
  83.                 -------------------------------------------
  84.  
  85.  
  86. A. Creating a field with a text editor
  87. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  88. (If you're using CygnusEd, you should set 'Insert mode' to 'off' and select an
  89. interlaced screen.)
  90. The field MUST(!!!) have a size of 106 x 58. If you use a larger field, you
  91. will get non-sense things, if you use a smaller field, the program will pro-
  92. bably hang. Comments may only be added at the bottom of the field.
  93. The field itself consists of (in this version) five reserved characters :
  94.  
  95.    - '.' for a background cell
  96.    - '=' for a wire cell
  97.    - '+' for an electron tail
  98.    - '*' for an electron head
  99.    - 'x' for a marker. (Remember to use a lower-case 'x')
  100.  
  101. The field must be saved using the standard ASCII format. The name should end
  102. with ".ASC.EW" (That makes it easier to load with Electron World and clearer
  103. to understand what kind of file it is).
  104. Some ready-to-use fields are included in the directory "Fields". You may use
  105. the fields "Empty.ASC.EW" and "Empty2.ASC.EW" (with a yellow bar at the right
  106. side, so that you see, how fast it's loaded) for creating your own fields.
  107.  
  108. B. Creating a field with Electron World
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110. Since version 0.50 there is a built-in editor in Electron World. See section
  111. "Operating the editor" for a detailed description.
  112. The created fields can be loaded, saved and deleted in the "Disk options" of
  113. the "Project" menu.
  114.  
  115.  
  116.  
  117.                            ---------------------
  118.                            5. THE "OPTIONS" MENU
  119.                            ---------------------
  120.  
  121.  
  122. A. You can select either "Save Icon" or "No Icon" in the "Options" menu. If
  123. ~~ you use "Save Icon" then there will be an Icon created for every field you
  124.    write to disk.
  125.  
  126. B. Electron World knows two file formats: The ASCII field format that is
  127. ~~ used by text editors if you are editing ".ASC.EW" files and the "Compressed"
  128.    format that is only used by Electron World (".EW"). If you don't want to
  129.    use a text editor for your fields, you should select "Save compressed",
  130.    because the "Compressed" format is only halfe as long as the ASCII format
  131.    and it is loaded and saved twice as fast. Your choice in the "Options" menu
  132.    is only needed for saving fields, because the load routine automatically
  133.    checks the file format and loads it properly.
  134.  
  135.  
  136.  
  137.                          ------------------------
  138.                          6. PROCESSING THE FIELDS
  139.                          ------------------------
  140.  
  141.  
  142. A. Start Electron World from the Workbench or the CLI. You don't need "run"
  143. ~~ or "runback", because Electron World is written as LSR (Load-and-stay-
  144.    resident).
  145.    Choose "Disk options" from the "Project" menu, select the file and click on
  146.    "Load".
  147.  
  148.  [ For programmers: There's a little bug in the documentation for SAS/C 5.10.
  149.    If you're linking with "cback.o" to produce LSR programs and you don't want
  150.    to perform any Output to the calling CLI window, you should though set
  151.    "_BackGroundIO" to 1 and close the handle that you get as soon as possible,
  152.    if you want the CLI window to go away. See "User's Guide" of the SAS/C
  153.    manual for futher information. ]
  154.  
  155. B. If you have the right path in the "DEFAULT TOOL" of your field icon, you can
  156. ~~ start Electron World directly by clicking on the field icon. Then the field
  157.    will be loaded automatically.
  158.    If the field is in the same directory as Electron World you may also use the
  159.    workbench's "extended selection". Click once on the field icon, then hold
  160.    down <SHIFT> and double-click on the Electron World icon.
  161.    If you have the ARP library in your libs: directory, you can use the FULL
  162.    "extended selection", which means that you may use all directories. You
  163.    may also click once on the Electron World icon, then hold down shift and
  164.    double-click on the field icon.
  165.  
  166. C. In the CLI you can specify the field directly after the command name. It
  167. ~~ will then be loaded automatically.
  168.  
  169. Select "Project" "Start/Stop" to start or stop processing the field. Select
  170. "Project" "Process 1 step" to process only one step. The step number is
  171. displayed in the information line at the bottom of the screen.
  172.  
  173.  
  174.  
  175.                           -----------------------
  176.                           7. OPERATING THE EDITOR
  177.                           -----------------------
  178.  
  179.  
  180. Since v0.50 Electron World has a built-in editor. It is not very comfortable,
  181. but certainly better than a text editor (And much faster, too, because you
  182. needn't go through that annoying save-edit-load-test-save-... procedure).
  183. The color/status of the field can be selected in the "Edit" menu. You can also
  184. use the key shortcuts (like everywhere in Electron World). Just click on the
  185. cell you wish to change and it will get the new status. You may also drag the
  186. mouse pointer over the field to get a continuous line. Use "Edit" "Clear" to
  187. clear the field.
  188.  
  189. There's also a very special function that can be useful when you're developing
  190. new elements or complete fields. If you've changed your field and want to test
  191. it, you often have to remove some "electron trash" that was left on the field
  192. by a non-functioning element. Since v0.60 Electron World can do this for you.
  193. Just select "Remove electrons" from the "Edit" menu and all electron heads and
  194. tails will get replaced by wire cells. You can also replace markers by back-
  195. ground cells with "Remove markers".
  196.  
  197.  
  198.  
  199.                              -----------------
  200.                              8. OTHER FEATURES
  201.                              -----------------
  202.  
  203.  
  204.                                  ICONIFY :
  205.                                  ~~~~~~~~~
  206. Since version 1.00 there is the item "Iconify" in the "Project" menu. If you
  207. select it, the screen and window of Electron World will be replaced by a small
  208. icon on the workbench screen. This will save about 53 kB of chip memory. If
  209. you want to get back to Electron World, just activate the icon by clicking on
  210. it and then press the right mouse button. The screen and window will be opened
  211. again and field will get redrawn. This can take (according to the field) up to
  212. 8 seconds. If there is not enough chip memory available to re-open, Electron
  213. World will quit. So be careful, if you don't want to loose your field !!!
  214.  
  215.  
  216.  
  217.                             ------------------
  218.                             9. THE DEMO FIELDS
  219.                             ------------------
  220.  
  221.  
  222.    +-------------------------------------------------------------------+
  223.    |   Test.EW            This is a simple demo field. I am using it   |
  224.    |                      for my performance tests. ( This version     |
  225.    |                      should be able to process this field for     |
  226.    |                      50 steps in about 11.35 seconds. )           |
  227.    |   Diode_Test.EW      This example shows how to draw and use the   |
  228.    |                      diode described in [1].                      |
  229.    |   Empty1.EW          Just an empty field.                         |
  230.    |   Empty2.EW          An empty field with a yellow marker line at  |
  231.    |                      the right side, so that you can see how      |
  232.    |                      fast it's loaded.                            |
  233.    |   Empty1.ASC.EW      Like "Empty1.EW", but in ASCII format.       |
  234.    |   Empty2.ASC.EW      Like "Empty2.EW", but in ASCII format.       |
  235.    |   Inverter_13.EW     This is an inverter like the one described   |
  236.    |                      in [1], that uses a tact rate of 13 steps.   |
  237.    |   Labyrinth1.EW      | These fields just produce some nice        |
  238.    |   Labyrinth2.EW      | pictures. Compute them and have fun !      |
  239.    |   Ornament.EW        This field is completely built with wire     |
  240.    |                      cells, so the electron in the middle can do  |
  241.    |                      what ever it wants to to. There's one fact,  |
  242.    |                      that makes this field interesting : Some-    |
  243.    |                      times the outline of the square is copletely |
  244.    |                      closed. This happens all 2k-1 [k¢Z] steps.   |
  245.    |   Memory.EW          A memory for one bit (WOW!!!) with a tact    |
  246.    |                      rate of 13. See description in [1].          |
  247.    |   Or_Test.EW         A testing picture for the "or" element       |
  248.    |                      described in [1].                            |
  249.    |   Title.EW           This one is just for fun.                    |
  250.    +-------------------------------------------------------------------+
  251.  
  252.  
  253.  
  254.                               --------------
  255.                               10. KNOWN BUGS
  256.                               --------------
  257.  
  258.  
  259.               "It's not a bug, it's an undocumented feature."
  260.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  261. I haven't found any bugs (yet). If you do so, please let me know it. Write to
  262. the address at the end of this manual.
  263.  
  264.  
  265.  
  266.                          -------------------------
  267.                          11. TECHNICAL INFORMATION
  268.                          -------------------------
  269.  
  270.  
  271. Electron World was written using SAS/C 5.10. The file requesters is my own,
  272. enhanced version of Anders Bjerin's "File Window". Thanks, Anders !
  273.  
  274.  
  275.  
  276.                               --------------
  277.                               12. DISCLAIMER
  278.                               --------------
  279.  
  280.  
  281. Electron World v2.01 was written by Stefan Zeiger in 6-11/1991. It is copy-
  282. righted (c) 1991 by ! WIZARD WORKS ! . This program may be distributed for
  283. non-commercial only. All files must be kept together and must remain unchanged.
  284. You may only charge a distribution fee less or equal to the fee that Fred Fish
  285. wants for his AmigaLibDisks.
  286. This program is distributed "as-is". ! WIZARD WORKS ! doesn't give any warranty
  287. for Electron World.
  288. Electron World is SHAREWARE. You may test it without paying for it. If you
  289. have decided to use this program, you have to pay 10 US$, 20 DM or 6 £ ster-
  290. ling. Send the money to the address at the end of this manual. You will then
  291. become a registered user and get informed about future releases of Electron
  292. World.
  293.  
  294.  
  295.  
  296.                                 -----------
  297.                                 13. HISTORY
  298.                                 -----------
  299.  
  300.  
  301. Here comes the version history of Electron World (beginning with the earliest
  302. version) :
  303.  
  304.       +-------------------------------------------------------------+
  305.       |  0.10a  First working test version.                         |
  306.       |  0.20a  File requester added.                               |
  307.       |  0.30   Icon save facility added.                           |
  308.       |  0.40   New save format "Compressed" added.                 |
  309.       |  0.50   Simple built-in editor added.                       |
  310.       |  0.51   "Remove electrons" facility added.                  |
  311.       |  0.52   Bugs fixed. Optimized version of "File Window".     |
  312.       |  0.60   WB and CLI argument getting facility added.         |
  313.       |  0.65   Bugs fixed.                                         |
  314.       |  1.00   "Iconify" added.                                    |
  315.       |  1.01   Slightly faster.                                    |
  316.       |  1.10   Full "extended selection" support with ARP library. |
  317.       |         First public release.                               |
  318.       |  1.20   Icon creation bug fixed. Fade in/out added. Securi- |
  319.       |         ty checks added.                                    |
  320.       |  2.00   New design. "Remove Markers" added. Second public   |
  321.       |         release.                                            |
  322.       |  2.01   File requester bug fixed. Now using WizardFiler     |
  323.       |         v1.01.                                              |
  324.       +-------------------------------------------------------------+
  325.  
  326.  
  327.  
  328.                         --------------------------
  329.                         14. SOME ADDITIONAL THINGS
  330.                         --------------------------
  331.  
  332.  
  333. Further information about the cellular automation that can be processed with
  334. "Electron World" is available in [1].
  335.  
  336.             Be C'ing you,
  337.             Stefan.
  338.                              ____
  339.                             / / /
  340.                     ____   / / /
  341.               Only  \ \ \ / / /|
  342.                      \ \ X / /_|
  343.                       \_X_X_/  |miga makes it possible !!!
  344.  
  345.  
  346.  
  347.                                ------------
  348.                                15. APPENDIX
  349.                                ------------
  350.  
  351.  
  352.                                 A. GLOSSARY
  353.                                 ~~~~~~~~~~~
  354.  
  355. CELL:     A cell is a single part of a ->field that can have one special
  356. ~~~~~     status (see 1.).
  357.  
  358. FIELD:    The field is the whole area that is computed by Electron World. It
  359. ~~~~~~    consists of 106 by 58 ->cells.
  360.  
  361. STEP:     A step in Electron World is a time measure. At each step the ->cells
  362. ~~~~~     of the ->field are computed new.
  363.  
  364.  
  365.                          B. ADDITIONAL INFORMATION
  366.                          ~~~~~~~~~~~~~~~~~~~~~~~~~
  367.  
  368. [1]       "Scientific American" / "Spektrum der Wissenschaft" 3/1990.
  369.  
  370.  
  371.  
  372.  
  373.  
  374. -----------------------------------------------------------------------------
  375.  
  376.    STANDARD MAIL :     ! WIZARD WORKS !
  377.                        Stefan Zeiger
  378.                        Seligenstaedter Weg 24
  379.                        D-W-8756 Kahl
  380.                        West Germany
  381.  
  382.            VOICE :     (49)-6188-2525
  383.  
  384. -----------------------------------------------------------------------------
  385.